home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / mmdemo.zip / MM-MULT.ZIP / UPGRADE.DOC < prev   
Text File  |  1992-07-04  |  12KB  |  257 lines
  1.             UPGRADING TO VER 2.0 OF THE MAINMAIL SYSTEM
  2.             ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3.  
  4.    First, you MUST upgrade your Gap to version 6.0 BEFORE upgrading
  5. your Markmail Ver 1.x to The MainMail System.  DO NOT begin this
  6. procedure until Gap Ver 6.0 is COMPLETELY upgraded and running.
  7.  
  8.    The MainMail System changes many things from Markmail Ver 1.x.  To
  9. begin with, there is no conversion for your old Markmail.USR file, so
  10. your users will have to reregister themselves and reselect their
  11. forums through MainMail.  If you followed the Gap 6.0 upgrade docs to
  12. the letter, you have most likely already unregistered your users from
  13. all public forums anyway.  I pondered writing a conversion program,
  14. but decided that most if not all of your pointers etc would be lost in
  15. the Gap conversion anyway.
  16.  
  17.    First, The MainMail System Ver 2.0 uses a new ISAM user file,
  18. located in your Gap MAIN directory, named MMUSER.DAT with an
  19. associated index named MMUSER.IDX.
  20.  
  21.    Second, The MainMail System uses a new configuration file called
  22. MMDAT.CNF.  This file can, as before, be located either in your Gap
  23. MAIN directory, or in the current directory.
  24.  
  25.    Third, The MainMail System uses a new encryption scheme for the key
  26. file, so your old MARKMAIL.SYS file is no longer valid. You MUST
  27. obtain a passcode from The Main Shop BEFORE your MainMail door will
  28. function properly.  If you have not obtained the passcode for your
  29. copy of MainMail, it will run as a demo until you do.
  30.  
  31.    Now, on with the show......
  32.  
  33.       1). Delete your MARKMAIL.SYS and MARKMAIL.USR files.  They are
  34.           no longer used.  Also, delete any old copies of MMSM.EXE and
  35.           MM-GAP.EXE that you still have.
  36.  
  37.       2). Rename your MARKMAIL.DAT file to MMDAT.CNF.  The MainMail
  38.           System will detect the older format, and update this file
  39.           the first time either the door is opened, or MMSETUP is run.
  40.  
  41.           a) If you wish, you may delete MARKMAIL.DAT, and MMSETUP
  42.              will create a new one the first time it is run.
  43.  
  44.       3). Copy (unzip) the EXEs to your path, or wherever you had
  45.           MM-GAP.EXE and MMSM.EXE before.
  46.  
  47.           a) There are three EXEs.  MM-GAP.EXE, MMSETUP.EXE and
  48.              MMPACK.EXE.
  49.  
  50.       4). Copy (unzip) the new GEN dir files, (MM-MENU etc) to where
  51.           you had them before, or update your old MM-MENU file to add
  52.           the new commands.  (See the MM-MENU file provided for a
  53.           summary of all available commands).
  54.  
  55.       5). Copy (unzip) the HELP.ZIP files to wherever you had the old
  56.           Markmail help files.  Be sure to overwrite or delete the old
  57.           ones, they have all changed!
  58.  
  59.       6). Run MMSETUP.EXE and make any necessary changes, updates to
  60.           your paths, and filenames.  If you wish, you may delete your
  61.           old MARKMAIL.DAT file (MMDAT.CNF) and MMSETUP will create a
  62.           new one.  If you decide to do this, MMSETUP will read your
  63.           Gap setup and fill in the most common paths, protocols, and
  64.           compression methods for you.  MMSETUP assumes that you are
  65.           running MainMail from your Gap default dir as an integral
  66.           part of Gap.  See the documentation for more details on
  67.           running MainMail from its own directory instead.
  68.  
  69.       7). FROM YOUR GAP DEFAULT DIRECTORY, run MM-GAP with the
  70.           <register> parameter.  Like this:
  71.  
  72.           mm-gap register <enter>
  73.  
  74.           Answer the questions as they come up, and enter your
  75.           passcode obtained from The Main Shop or from your
  76.           registration letter.  MainMail will create a new MMSYS.DAT
  77.           (formerly MARKMAIL.SYS) file in the current directory.  Once
  78.           finished, you may copy this to your Gap MAIN directory and
  79.           MainMail will find it there for all nodes.
  80.  
  81.           That's it.  Your MainMail door is ready to run.  MainMail
  82.           will create new MMUSER.DAT and MMUSER.IDX files the first
  83.           time the door is opened.
  84.  
  85.    -------------------------------------------------------------------
  86.  
  87.    Changes in The MainMail System Ver 2.00.
  88.  
  89.    1) The MainMail System now writes directly to the Gap caller logs.
  90.       A list of caller log codes and their meanings is contained in
  91.       the appendixes of The MainMail docs.
  92.  
  93.    2) MainMail now reads a user's default protocol from Gap when a new
  94.       user first opens the door, and if that same protocol letter is
  95.       configured in MainMail, that protocol will be the user's default
  96.       in MainMail.  This should provide one less thing for the user to
  97.       have to set up in MainMail.
  98.  
  99.    3) Added 'DQ', 'UQ', and 'UG' commands.  These are, Download/Quit,
  100.       Upload/Quit, and Upload/Goodbye respectively.  Try them.
  101.  
  102.    4) MainMail will operate locally from the command line using either
  103.       of these switches:
  104.  
  105.       '-U' uploads a local packet from the path configured in MMSETUP.
  106.       '-D' downlaods a local packet to the path configured in MMSETUP.
  107.  
  108.       NOTE: MainMail still requires a DOOR.SYS file to be present in
  109.             the default directory when operated locally.  MainMail
  110.             obtains the user's name currently in the door from
  111.             DOOR.SYS.  If you intend to operate MainMail in an event
  112.             or at any time locally, you MUST have a copy of DOOR.SYS
  113.             in your Gap defualt with YOUR name in it as the user
  114.             currently logged on.  I did this by creating a directory
  115.             under the default called 'dorsys' and copying DOOR.SYS
  116.             into it.  Then, whenever I run MainMail locally, I do so
  117.             from a batch file, and copy that DOOR.SYS to the defualt
  118.             directory immediately before running MainMail. For
  119.             example:
  120.  
  121.             MMU.BAT          <Local upload batch file>
  122.             -------
  123.             @echo off
  124.             copy .\dorsys\door.sys
  125.             mm-gap -u
  126.  
  127.             MMD.BAT          <Local download batch file>
  128.             -------
  129.             @echo off
  130.             copy .\dorsys\door.sys
  131.             mm-gap -d
  132.  
  133.             As a side benefit of this, you can accually have any
  134.             number of door.sys files in that directory, each with a
  135.             different name.  This might be desirable if several people
  136.             all obtain their mail locally through MainMail.  Here is
  137.             an example to how this might work:
  138.  
  139.             MMD-JOHN.BAT     <John Smith's Local Download batch file>
  140.             ------------
  141.             @echo off
  142.             copy .\dorsys\john.sys   <door.sys for John Smith renamed>
  143.             mm-gap -d
  144.             ren d:\path\idcode.qwk d:\path\john.qwk
  145.  
  146.             <d:\path> would be your local download path as configured
  147.             in MMSETUP.
  148.  
  149.  
  150.    5) There will be a DEMO version available soon.  This will
  151.       hopefully allow more potential MainMail sysops to try the door
  152.       before buying it.  The demo will be FULL FEATURED, and will have
  153.       not be crippled except that it will only allow 20 users in the
  154.       user file.  The QWK file name will be DEMO.QWK(REP).
  155.  
  156.       Please make this demo version available to your users to
  157.       download.  Thank you!
  158.  
  159.    6) MainMail creates a WORK directory either under the current
  160.       directory, or off of the root of the directory specified in
  161.       MMSETUP.  Previous versions of Markmail For Gap deleted this
  162.       directory when done with it.  MainMail now leaves this directory
  163.       in place upon exit.  This allows Novell network administrators
  164.       to flag that directory as a PURGE directory without MainMail
  165.       disturbing those attributes.  This WORK directory is named
  166.       'MWORK' for single node versions, or 'MWORKxx' for multi-node
  167.       versions, where 'xx' is the node number.  (01 thru 99).
  168.  
  169.    7) MainMail now extracts new files and bulletins on a forum by
  170.       forum basis during the download process.
  171.  
  172.    8) MainMail includes a new file in the packet called 'DOOR.ID'.
  173.       This file will inform the mail readers about the door, and help
  174.       to implement off-line configuration more easilly.
  175.  
  176.    9) MainMail also includes a new pointer file in the packet.  This
  177.       file, named idcode.PTR is a standard C struct and utilizes the
  178.       following format:
  179.  
  180.       struct pointer
  181.       {
  182.          unsigned int forum;      /* Forum number for this record   */
  183.          unsigned int misc;       /* For future use                 */
  184.                  long highnum;    /* High msg number for this forum */
  185.       };                          /* 8 bytes per record             */
  186.  
  187.       Developers and Mail Readers may use this file any way they wish.
  188.       This information is provided as a courtesy for those of you who
  189.       wish to use this file.
  190.  
  191.       There is one record for each forum CURRENTLY SELECTED.  No
  192.       record appears if the forum in question is not selected.  If a
  193.       record is added to this file, and the file uploaded in a mail
  194.       packet, MainMail will add that forum to the list of selected
  195.       forums, with flags set to ALL MAIL and set the high message
  196.       number to the number appearing in the new record.
  197.  
  198.       Additionally, if an existing record is modified, IE: high number
  199.       changed, and the file is included in an uploaded packet,
  200.       MainMail will make the changes reflected in the updated record.
  201.  
  202.       Some caution should be exercised when manipulating this file.
  203.       If a random or garbage number is placed in this file, and the
  204.       file is uploaded, MainMail will take the data as valid and make
  205.       the changes unconditionally.  In other words, if a high number
  206.       of 60 million is placed in the record for forum 5, MainMail will
  207.       set the high number for forum 5 to 60 million.
  208.  
  209.   10) MainMail deletes the REP packet when a successfull LOCAL upload
  210.       is performed.  This should help to prevent those occational
  211.       infections of FHD we all have.  (Ask Frank Hagan what FHD is!)
  212.  
  213.    ------------------------------------------------------------------
  214.  
  215.    New Utilities....
  216.  
  217.    MMPACK.EXE - Packs your MainMail user file.  No command line
  218.                 parameters are needed or accepted.  This program does
  219.                 nothing more than read your MMUSER.DAT file, and check
  220.                 that each user exists in Gap.  If a user does not
  221.                 exist in Gap, s/he is deleted from the MainMail user
  222.                 file.  The intended purpose is to perform the accual
  223.                 purge of users from Gap using GAPPACK, then run MMPACK
  224.                 to 'sync' the MainMail user file to the Gap user file.
  225.                 Simply add the line 'MMPACK' to your event immediately
  226.                 following the GAPPACK on your user file.
  227.  
  228.                 MMPACK.EXE renames your MMUSER.DAT and MMUSER.IDX
  229.                 files to MMOLD.* in your MAIN directory.  You may
  230.                 leave them there, or delete them after the pack is
  231.                 complete.  If you leave them there, MMPACK.EXE will
  232.                 overwrite them the next time it is run.  This could be
  233.                 considered a safe way of always keeping a backup of
  234.                 your MMUSER files.
  235.  
  236.                 THIS IS A SINGLE USER PROGRAM!!!  ALL NODES MUST BE
  237.                 SHUTDOWN BEFORE RUNNING THIS PROGRAM!!!  THIS PROGRAM
  238.                 MUST BE RUN FROM YOUR GAP DEFAULT DIRECTORY!!!
  239.  
  240.   MMSETUP.EXE - This program replaces MMSM.EXE.  All operation is
  241.                 similar or identical to before.  There are two major
  242.                 differences.
  243.  
  244.                 First, in a NEW installation, (one where MMDAT.CNF
  245.                 does not already exist), MMSETUP creates a new
  246.                 MMDAT.CNF file with all common protocols, compression
  247.                 methods and directoried already entered for you.
  248.                 Should save some typing.
  249.  
  250.                 Second, the user file editor is now operative.  You
  251.                 can edit or delete existing user records from your
  252.                 MainMail user file when desired.  If you have the
  253.                 multi-user version of MMSETUP, it can be run at the
  254.                 same time the MainMail soor is running on another
  255.                 node.
  256.  
  257.